ORIGINAL ARCHIVER OPERATING 
INSTRUCTIONS 

These instructions describe the 
operational procedures for the 
original ARCHIVER only. 
Installation instructions have been 
deleted. i 



2.1.2 Normal Backup Procedure 

1. Follow the boot procedure piven above (with a copy 
of the ARCHIVER/EDITOR oiUy). 

2. When the ARCHIVER poge is displayed (screen 
changes to a brownish-yellow) then press C (f^r 
Copy). 

3. Tine ARCHIVER will respond hy asking you to insert 
source diskette. Now insert tli" program you wish to 
baclcup and then press the START button. 

4. After a short time, you will be requested to insert 
destination diskette. At this time, you should insert 
the diskette you wish to put the copy on. When you 
have done this, press the START button. 



NOTE 

The destination diskette does not have to be 
previously formatted. The ARCHIVER/ 
EDITOR program formats each track as It is 
written if the parameter Is selected. 



5. If the ARCHIVER asks you to insert the source 
diskette again and repeat steps 3 and 4. 

6. Depending on the length of the program, from 1 to 3 
passes may be required on a 48K computer. The 
larger the computer memory is, the fewer the 
number of passes required. The ARCHIVER will 
indicate on the screen when the copy is done. 

7. We suggest that you put the original diskette awny in 
a safe place and use the backup copy from this time 
on. 

If you got a Read Format Error, most likely you did not follow 
steps 3 and 4 of the boot procedure carefully. Otherwise the 
command option parameters may require some changes to 
enable you to custom modify the diskette copying technique 
(refer to sections 4.t and 4.3). 



2.2 SOME CONVENTIONS DSED 



All numbers used In the ARCHIVER/EDITOR progrum 
are in Hexadecimal (HEX) which is a base 16 number- 
ing system. If you do not understand hexadecimal 
numbering, then refer to the table in Appendix A. In 
this manual til HEX numbers are preceded by a $ 
symboL 
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2. In the ARCIIlVLIl/EDiroU program pressing the 

ESC key will bring you back to the command mode 
of the program you are currently in. The only ex- 
ception is during actual ilisk I/O, (R/W) in which ease 
holding down the OPTION button will stop the disk 
I/O at the end of the track read/write operation 
which then allows you to abort the operation by 
pressing the ESC key or to press START to 
continue the 1/0 operation.. 

3. Whenever disk I/O needs to ho performed or contin- 
ued you must press the START button to proceed. 

4. At anytime during the use of the EDITOR program 
(except during disk l/Ol a CRTL-P will create 
printout of what is currently on the screen on your 
printer. 

5. The CTRL and SHIFT keys need never be used 
except for printing as described in 4. (However you 
may press CTRL or SHIFT if you like, but these 
key functions are disregarded and unnecessary.) 

6. Whenever any writing is to ho performed the border 
color will change to red. Whenever any reading is to 
be performed the border color will change to white. 



CnAPTER 3 
SCRJBEN CONVBNTIONS 



This chapter deals with the various command lines nnd 
prompts used by the ARCHrVER/EDfTOR program. You 
should read the following chapters to become aware of all the 
many capabilities provided by this program. 



3.1 ON TUB SURFACE 



Figure 3-1 shows the screen for the ARCHIVER. However, the 
EDITOR, the FORMATTER, MAPPER, and the DISAS- 
SEMBLER screens all have similar Option, Status, and Cnm- 
mand lines. The Option and the Status lines provide in unique 
parameters for disk sector/track format changing. The 
following paragraphs expUin how to use each parameter. 
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Figure 3-1. Screen Program Lines 



3.2 THE OPTION LINK 



1.2.3 Track Konge 



The option line contains parnmetcr'! ii>:cd by the ARCHIVER 
(snd EDITOR). AU of these pnrainetor^ onn be chungeO at any 
time when you are In the eomm«n<l ino<!e. To mo<lify the.'(» 
parameters type P . You wiU see a cursor on the option line. 
To move the cursor right a/id left press the * or ♦ key 
(without pressing the CTRL key). Pressing RETURN 
selects that parameter to be changed. After the parameter 
has been changed the cursor will be on the option line ready to 
select another parameter to change. Pressing the ESC key 
returns control back to the command leveL A description of 
each parameter follows. 



3.2.1 Sotree Drire 



Sa This is the drive number from which all reading is 

done. Pressing a RRTURN when on this 
parameter will increment the drive number and 
wrap around at four (4) to one (1). NOTE: This 
drive must be opened prior to reading from it, 
otherwise an error will occur (this drive must also 
have a CHIP installed). 



R:iat,yy This is the range of tracks that will be eopicl 
U'ing the ARCHIVER (or tracts 
read/written/formatted... when using the 
1 EDITOR). The xx is the start track and the 

yy is the end track. When pressing RETURN 
with the cursor positioned on this parameter a 
prompt will appear on the command line 
requesting a new range of tracks. There are three 
allowable syntaxes: 



RETURN 



z 



same as typing 00,27 (tracks 00 to 
27 HEX). 

set start to z and end track to y. 
set both start and end tracks to z. 



ESC will exit this option without modifying the 
range of tracks. RETURN enters the range you 
entered and updates the option line accordingly. 
If you make ui illegal entry a track range error 
occurs. 



3.2.4 Verify 



3.2.2 Destioatioa Drive 



Dai This is the drive number to which all writing is 

done. Selecting the drive is accomplished the 
Mine way as described in section 3.2.1 above. 



This is the write with verify flag. Pressing a 
RETURN simply toggles this parameter: 

♦ : Verifv on. 
- : Verify off. 

If the verify is on, a verification will be done on 
the track after It is written. NOTE: Because the 
verify pass Is separate from the write pass, it is 
faster than the standard 006 write with verifv. 
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3.2.5 Lope Scekine Read/Write 



This is the rend/write lofric seeking flag. Hitting 
t RETURN simply toggles this parameter: 

♦ ! Logic seeking on. 
- : Logic seeking off. 

When reading or writing multiple sectors with the 
same number (i.e. two sector $09) you must be 
able to read or write the correct sector, there- 
fore, there are logic seeking read/write com- 
mands in the CHIP that eiilomatietUy synchronize 
to the format on the track and read/write the 
correct sector. Since synchronizing to ■ track 
takes t little more than one revolution, these 
commands are slower than the standard read/ 
write commands. The only time you would want 
to ehtnffe this to a - is when the format cannot 
be synchronized (see section ».l). If the logic 
seeking is off, it is suggested that you turn 
compaction off (refer to section 3.2.6). Notet 
The ARCHtVER/EDITOR programs only use the 
logic seeking commands (if enabled) when a non- 
■ unique numbered sector is to be read or written. 



3.2.1! Compaction 



? 

T 



C+ This Is the compaction flag. Simply pressing 

RETURN toggles this parameter; 

♦ ; Compaction on. 

Compaction off. 

If you have compaction on when using the ARCH- 
IVER, the sector will neither be read nor written 
by the ARCHIVER/EDITOR If It is fiUed by a 
single value (I.e. $00 etc.). If you are in the L- 
mode you should have compaction off. Sectors 
filled with the values $01-$08 will not be 
compacted as these are format control bytes. 
These "fill" bytes are placed in the sector 
automatically when the track is formatted. 

The C parameter has the same function in the F.niTOR 
as it does In the ARCHIVER. however, in the EDITOR the 
results are more readily apparent. Compaction only works on 
sectors which are not bad and that have single byte fiUing the 
entire sector. Also, sectors filled with the values of $01-$n8 
will not be compacted. If the sector was compacted, the 
EDITOR will NOT display the data in the sector. The EDITOR 
wiU onlv dispUy sectors It aetuaUy read. The CHIP actually 
reads the data and reports back to the EDITOR that the sector 
is to be compacted, thus saving time on reading a diskette. 



3.2.7 Format Read Type 



A6+ This is the type of track reading that the ARCH- 

IVER/EDITOR pro(Trnrn will use to determine the 
format on the tracks. Either 4 or 6 bytes of 
inXormatjon about the sector can be selected (A4 
or A6). The ♦ or - is the toggle to turn on 
(+) or off (-) the format verification logic. 
Normally the A6* will be desired. To change this 
parameter, simply press RETURN with the 
control cursor positioned on the A6 . The 
meaning of each of the codes is as foUows: 

( I Six bytes nrc returned to the ARCII- 

IVER/EUITOR for each sector, thus 
the AIICHIVER/EDITOR will be able 
to rotate the sequence so that the 
end-of-track gaps will be identical 
{ AS* only). This is mainly 
cosmetic, but does have significance 
on fast formats. 

Because 6 bytes are returned, a max- 
imum of 21 srctors per track can be 
fetched. If there are more than 21 
sectors, then a 4 mode should b« 
used. 

4 : Four bvtes are " returned to the 
AKCIIIVER/FDITOR for each sector, 
thus some iriforinalion about each 
sector is iiussitig. This is intended 
for 22 to 24 sector formats. 

+ : The track is cycled through twice 
comparing the first sector sequence 
to what the CHIP finds the second 
time. This is an internal function of 
the CHIP. 



- : This mode Is slightly faster than the 
♦ mode, however, no verify is done on 
reading the format. This is generally 
used for speed and also if the traei' is 
badly garbled. (Unformatted tracks 
can return strange sector headers on 
lome diskettes.) 

For more Information on the difference on the 6/4 
byte read distinction, see section S.IS. 



Format Flag 



This Is the format before write flag. Normally 
you wlU want a P* mode. Simply pre.ssing 
RBTDRM will toggle this flag when the cursor 
is positioned on the t* . 

♦ I Format track before doing the write 
pass. 

- ! Do not format This option Is select- 
ed if you already have an Identical 
format on the tracl< or If you are 
simply trying to put sectors on the 
destination track. If there are mul- 
tiple sectors with the same number 
and the track formats are not Identi- 
cal the logic seeking read/write 
commands will not work correctly. 
Also, the verify may not work cor- 
rectly If It tries to verify the wrong 
sector. This flag also allows you to 
convert slow formats by first 
formatting the destination track with 
a fast format and then write out the 
sectors that were read from a slow 
formatted diskette. 
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3.2.9 Screen Code Conversion 



S* This Is used In the miTOR only. It refers to the 

conversion of characters dispLiyed on the normal 
EDITOR page to the riijht of the sector display. 
A RBTUSM toggles this parameter. 



THE STATUS UNE 



Convert 
characters. 



data 



to 



ATASCII 



No conversion, 
screen codes. 



Display data as Atari 



3.2.10 Bad Sector (CRC) 



B+ This flag refers to thp mrlliod of writing CRC bad 

ieeton. Pressing RF.TUIIN t0(;ples flng on (♦) 
or off (-). This flag should always be set to 
when in the ARCMIVER. 

* : Write a full bad CRC sector. 

- : Only write a partial sector (CRC 
bad). The number of bytes written 
depends on the last byte of the sector 
data. That hyte refers to the number 
of bytes that will be written. This 
allows for the capability of increas- 
ing the number of sectors on a track 
to above 20 (i.e. two half sectors 
. . take about the same amount of room 

as a full sector). 



The status line is the third line on the screen. It will display 
the current track, sector, composite sector number, tlm 
amount of free buffer memory, current copy number and the 
number of copies to make (in the ARCHIVER or the scoter 
data address in the EDITOR). The only directly adjustable 
parameters are the CO:xx which refers to the number of 
copies to make and the LOCtxxxx which is the sector start 
address. The status line parameters are as foUows: 



TRa 



SBax 



PU 



This is the current track number the 
ARCHIVER/EDITOR ii processing. (Tracks 
range from lOO-fJT.) 

This Is the current sector number the 
ARCHIVER/EDITOR Is pttjces-sing. (Sectors 
range from S01-$12, a — means that the 
sector number is invalid.) 

This is the composite sector number used by 
Atari DOS. These numbers are arrived at by 
the formula FM » TR*$1>«SE. Where TR is 
the track number and SE is the sector 
number. The FM ranges from SOOl to $2D0. 
A — indicates that the sector number is 
Invalid. 

This Is the current free memory for storage 
of the sector data and track information. 
When data is being read into the buffers, the 
memory counter will decrement J80 for 
each sector read and also for each track 
read. NOTE: If compaction is on, 
compacted sectors do not take up memory 
space, however, there Is a $10 byte over- 
head to store sector layouts and various 
other information for each track. On s 48K 
macliine this field wUl read $9900 (about 
38K). 



NO:zz 



CO:z 



LOC 



This IS the number of the copy being made. 
A $00 indicates it is on a read pass. A $01 
to IFF is the number of the current copy 
being written. 

This is the number of copies to be made per 
each rend pass. 1'his is defaulted to on* 
($01) whenever the ARCHIVER program 
mode is entered. This value can range from 
$01 to $FF. 

This parameter is used with the EDITOR and 
is the address location in which all 
disassembly or displnys of sector data will 
start. This is for purely comrstic reasons 
and does not affect the data (refer to 
section 5.12). 



3.5 OPEMWG/CLC36ING THE CHIP 



Normally the CHIP will already b« open if the Disk Drive is 
booted correctly (refer to section 2.1). However, there mny 
be some eases In which you will need to open a drivr. 
(Opening a second drive for example or If the drive 
booted correctly.) To open the CHIP, type an O when in the 
command mode (in either the ARCHIVER or EDITOR). You 
will be prompted to enter the open code and drive number. 
Enter your code, and the drive number (optional— the default is 
one). If you enter a wrong coda or Just press RETURN , the 
CHIP will eloM. Preaaing BSC aborti thla option. 



3.4 THE COMMAMO LINE 



The command line is at the bottom of the display. This line 
will contain all necessary screen prompts, input commands and 
error messages. When using one key command entries no 
RETURN is necessary to ennbic that command. Simply 
press the desired key for the desired command input. 
However, on numeric Input pressing RETURN is necessary 
to enter the numeric information. 

Also, pressing the space bar will erase an error message or 
copy done/aborted message immediately. Otherwise the 
message will disappear after approximately 4 seconcb. 
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3.6 SECTOR OtSPLAT FORMAT 



The ARCHIVER/EDITOR's sector Inyout displayed on the 
screen is somewhat unique. Field (a) (shown in figure 3.2) Is 
the track number (HEX) from where the sector sequence 
came. The numbers In field (b) represent the actual sector 
numbers on the track and are in the sequence as found on that 
track. The numbers are read vertically (i.e. figure 3.2 shows 
track * $01, sectors = $12. $01,...). Generally there will b« 
$12 sectors (18 decimal) on a track. However, this can vary 
from one software protection scheme to another. Field (e) 
represents the status of the sector. If there Is a symbol under 
the sector number, the sector is considered 'ba<f and will 
return a bad sector status If read (a protection technique). 
Refer to table S.I in section S.IO and to section 6.11 for each 
symbol's meaning. The sector numbers can be in any order and 
need not be unique. Two (or more) reads of the same sector 
number need not return the same data. 



These track and sector numbers are not used Internnlly by thr 
Atari computer. Instead, the operating system refers to each 
sector as a number from $001-$2D0 (1-720 decimal). He 
computer's disk operating system (or DOS) will aeee.<is the Disk 
Drive using this composite sector number. Then, within the 
Disk Drive, the composite sector number is broken down into a 
track and sector number using the relationthipt 

composite - (track) * ($12) * (sector) 

Thus, the first sector in figure 3.2 ($12) would be called $:i 
(36 in decimal) within the computer. Notice in the figure thnt 
there are two sectors with the number $09. If the Atari 
computer were to read sector $2B (composite remember), it 
would get one of the two poaaible sectors. This is called a 
'double sector*. 
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Figure 3.2 Track/Sector Display Format 

For detailed Irtformation on the source of these sector num- 
bers, refer to the section on the track layout (section 6.3) and 
the following paragraph. 



CHAPTER 4 
THE ARCHPTER 



Thp ARCHIVER sn sutomgtic copier desifrned to copy your 
prolpctod (or unprotected) so(twar« for backup purpo-ic!. Thi' 
ARCMIVER Li easy to use and will backup virtually all 
protected software. 



4.1 AN OVBRmW 



In general, diskettes can be copied by simply typing a C . 
For some special disk formats It may be desirable to change 
several of the ARCHIVER operating parameters. The 
ARCHIVER will allow the making of multiple copies per each 
read past. On a 4gK system a disk will take up to 3 passes to 
copy. However, most diskettes can t>e copied In one or two 
passes depending on the amount of data on the diskette. 

As a safety feature the ARCHIVER/EDITOR requires that you 
press the STABT button before any disk reading or writing 
will take place. If you wish to abort the reading or writing 
during disk I/O press the OPTION button and hold it down 
until the track is completely read or written. To continue 
press the STABT button and to exit the operation press the 
ESC key. The ESC key will always return control to the 
previous command mode while disk I/O is non-active. 
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4.2 NUUBBR OP COPIES 



This command wlU allow you to select the number of copies 
that wiU b« made on each read pass. To enter the number of 
copies you wish to make, type an N . You will be prompted 
to enter the number of copies to make. Type the number (in 
HEX) followed by a RETORM . The number selected will be 
reflected after the CO . When mnking copies on a .single 
drive, screen prompts will signnl when to insert the source 
diskette and when to insert the destiimtion diskette . On a two 
drive system (both with a CHIH), the first copy will be made 
automatically and subsequent copies wiU be prompted. The 
number after the NO indicates which copy is currently 
delng proeesed. A $00 means you are on the read pass. 



4.3 AtrrOUATIC COPT 



The command to start making copies is Initiated by pressing 
the C key. When activated, screen prompts will be 
displayed for Inserting the source (original) and destination 
(backup copy) diskettes throughout the process. Remember to 
press STABT to acknowledge to the prompt that you are 
ready. The copy command C makes the number of copies 
specified by the COtxx field and does its function.^ according 
to the parameters on the option line (if applicable). The 
memory buffer containing the previously read data will be 
elaared prior to each read pass. 



If you have problems copying, cheek the following: 
I. Change to a different destination diskette. 
A6* to A6-. 
AS, L, and C to -. 



If the diskette has 20 or more sectors on a truck, then 
read each sector/track using the Editor and write It onto 
the destination diskette. Refer to sections 6.11 and 8.2. 

Be sure you have a data separator board and that the 
disk drive is running at the right speed. 



4.4 EMTEB EOITOa 



To enter the EDITOR type B 
memory buffers will transfer. 



All data currently in the 



pn 
m 
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CHAPTER 5 
THE EDrrOR 



The EDITOR wlU nUow you to actually edit the sector dnta 
and do many manipulatlona with It. Custom formatting can 
also be done, thus enabling you to make protection schemes or 
modiTy protection schemes as desired. Because formats can 
now have over 19 sectors, the EDITOR Is necessary In order to 
duplicate these sophisticated formats. (Formats greater than 
19 sectors have never been used to protect diskettes designed 
for use on the Atari eomputen before the Introduction of the 
CHIP.) 
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Fi(we S.l. EDTTOR Screen 
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9.1 AN ovBsmw 



The EDITOR Is designed to be easy to use yet It doesn't lack in 
sophistication. One key commands allow you to browse through 
the many parts of the EDITOR. Unlike the ARCHIVER, only 
one track's sector list will be displayed at a time. The 
EDITOR allows you to move between sectors by simply 
pressing the left and right arrow keys ( ♦ and ♦ ). You will 
notica the dual purpose of the track format lines as both a 
sector MleetJon aid and as a sector layout display. This will 
be discussed In more detail later. The normal EDITOR display 
will b« of the actual sector data of the sector that the cursor 
is on (on the sector layout lines). If there ia no track in 
memory, the sector layout lines will be blank. 

The main sector data display will contain data only If there Is 
at least one track in the memory buffer and the sector that 
th« cursor is on eontaJns data. 



5.: BZADUia TBACES 



To read in a range of tracks first be sure that the RncK,n 
parameter is correct, then type an R followed by pressing 
the STAIT button to start the read process. As a safety 
feature. If a track Is currently in memory that was specified in 
a read operation, the reading of that particular track will not 
occur. That track will be skipped and the read process wUl 
continue with th« next track. 



5.3 WlirnNQ TRACKS 



To write a range of tracks first set the track range (as in the 
read). Press W along with START to Initiate the writing 
process. Only the tracks and sectors actually In memory 
within the range selected will be written. If formatting is to 
occur before the write, the fill bytes will be written during tlie 
format on compacted sectors. If a sector was deleted thnt 
sector will not b« written. It formatting Is on then zeros will 
riU that sector. 



S.4 ENTER EDIT MODE 



Prior to entering the Edit Mode, the sector data must first be 
displayed. If so, press E to enter the Edit Mode. 
Otherwise, read In the track you want to edit, then press E . 
Tho cursor appears within the sector data and you may <:lnrt 
editing the code. The commands available for use while in the 
Edit Mode are as foUowsi 

«■ : Move cursor one byta toward the beginning 
of th« buftar (la(0. 

* I Move cursor on* byta toward the end of 
th« buffer (right). 

t I Move cursor eight bytes toward the begin- 
ning of the buffer (one line up). 

4 I Move cursor eight bytes toward the end of 
the buffer (down one line). 



m 
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RETUBM : Move the cursor to the t>eginning of the 
next data line. 

DELHTB I Delete the byte the cursor is on. AU data 
beyond the cursor moves up one byte and a 
zero is pinccd in the last byte of the 
sector. 

INSERT ; Insert a byte at tlio cursor position. AU 
data moves down one byte from the data 
that the cursor was on. The last byte of 
the buffer is lost. 

CLEAS : Fill the entire hurfcr with the character 
currently under the cursor. 

H : Move the cursor to the first byte in the 
buffer. 

zz ! Typing HE.X numbers changes the data to 
exactly what you see. The cursor will 
automatically move to the next hyte when 
a byte has been entered. All spaces are 
automatically skipped between each byte. 

ESC ! Exit the edit male. All changes will be 
saved to a memory buffer (not the disk) 
and are permanent unless changed later. 
This will also update the characters on the 
right to their new value. (This is not done 
automatically during the Edit Mode.) 

The address at the left Is arbitrary niid is used strictly for 
reference. The address can be changed by the L command 
(sc« section 5.12). 



S.S DBASEMBLT 



The EDITOR has a built In disassembler. First enter the Edit 

mode and then move the edit cursor to the byte at which vou 

wwh to begin the disassembly. Exit the Fdit mo-lc (prp'=^ 
BSC ) and then press D to begin the dlsas.sembly. The 

disa.«embled Usting wiU Instantly be displayed on the screen. 

To scroU up or down the Usting press the up ( ♦ ) or down ( ♦ ) 
I arrows. The disassembly wiU not scroU above the hyte tlmt 

the edit cursor was on and the disassembly wlU not proceed 
I beyond the end of the sector. ScroUlng wiU occur in 

increments of eight lines. To exit the disassembler, press V\f 
BSC key. Pressing CTRL-P wiU dump the screen to a 

printer if desired. 



5.6 MOVEMENT BffTWEEN SBCTTOIS 



When in the command mode the cursor movement keys allow 
I you to move from one sector to the next. The right ( ♦ ) and 
I left ( ♦ ) arrow keys will move the sector cursor right and 
left. This aUows you to dlspUy any sector In that track. The 
up ( t ) and down ( + ) keys moves the Edit display screen 
between tracks. If the track is In memory that track wiU be 
1 displayed, otherwise, that track will b« skipped and the next 
track present wiU b« displayed. If the cursor happens to rest 
upon a sector which Is not In memory the sector data window 
wiU be blank. Sectors which have an x under them cannot 
be viewed. This Is because these sectors are inaceessable to a 
normal 810 Disk Drive. As you move from sector to sector, 
the track, factor, and eompoaite numbers are automatically 
updated. 
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5.7 CLEAB TSACK FROM BOfFBR 



5.9 TRANSFERRING SECTORS 



The CLEAR key wiU delete an entire track from memory. 
The next track wUl then be displayed. The memory indicator 
wUl •utomatieally be Incremented reflecting the deletion. If 
you wish to delete all tracks from memory, simply holding 
down the CLKAR key wiU do the Job. Pressing RESET 
also dean tracks from memory, but it sets all parameters to 
thair default TaJuM. 



Typing an H will copy the sector being displayed into a hold 
buffer. Pressing the INSERT key wiU copy the buffer to the 
sector the cursor is currently on. It a sector is being displayed 
the new data will simply replace the old. If the sector was 
originally empty the new data will simply be inserted. NOTE: 
AU disk I/O usea the same buffer so the data held wiU be lost. 



5.1 CLIAR SECTOR FROM BDFFER 



5.10 CREATING BAD SECrOB 



The DKLVn key will delete the sector currently displayed 
If no sector li belnf displayed, a beep wlU sound to indicate 
that there is nothing to delete. If a write oeetirs, that sector's 
data will not be written, however, the seetor header wiU be 
put on the diskette (if formatting is on). Deleting a sector 
iinply erasea ttie daU and does not modify the track layout 



When a seetor is being displayed you can cause that sector to 
be bad by pressing the B . When you do this, only a flag is 
changed so you must write the entire track in order for the 
sectors to be written as bad. If there is no data in the sector 
the seetor will not be written. Thus that seetor will not be 
bad on the track. ONLY SECTORS ACTUALLY WRITTEN 
WILL BE BAD (if they were selected to be bed). There are 
seven types of bad sectors possible using this method (see 
table 5.1). There are three flags that can flag a bad sector. 
Any combination of these three flags can be set by pressing 
B . The symbol under the seetor number will cycle through 
aU combination* of bad sectors plus one of good sector. The 
reason for having several types of bad sectors is that the three 
flags mentioned above can each be read and examined on an 
unmodified (10 Olak Drive. 



SYMBOL 


BIT 6 


BIT 5 


BIT 3 


n TT" q . 1^ T1 


1 


CLR 


SET 


CIO 


oil J : CRC 
error biL 


-1 

1 


1 




CLR 


BIT 5 ; Datn 










typ« Hag #1. 
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BIT 6 : Data 
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CLR 


CLR 


SET 
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SET 


CLR 
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+ 
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SET 


SET 




(blank) 


CLR 


CLR 


CLR 





Tabie 5.1. Type* of Bad Sector Symbolj 



When you preaj the B key the symbols cycle through In the 
order aj shown above. Only the last entry is a good sector. 

NOTE 

These bit numbers refer to the status byte 
returned when executing a STATUS COM- 
MAND (not the I/O status returned after the 
read). 



S.U CU5T0U POBMATTBH 



The Custom Formatter allows you to create your own sector 
layouts and format a range of tracks using your own layout. 
You can create any sequence of sector numbers you desire. 
The only restriction Is that only iceton with numbers between 
1 and 18 can b« read. 

To enter the Formatter type F . The Formatter has its own 
screen layout which allows you to set the formatting 
parameters (except for the range) In which you would like to 
format. Thus, before enteriri[ the formatter, you should 
select the range of tracks to fvmat from the EDITOR. 




Figure i-i. Formatter Traek Layout 
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The SB row contains the sector numhers which will be 
placed In the headers of the traek (refer to figure 5-2). The 
LN row contains the number of bytes that will he in the 
sector data and the FL row eontniiw the data fill byte that 
will go Into that particular sector. NOTE: Fill bytes of I to 8 
must not be used as these bytes have special signficance to the 
disk drive FDC circuit during formatting. Sector $03, for 
example, will only contain $40 bytes (64 decimal) and If read 
will return a bad status. Sector $n5 will contain the normal 
number of bytes, $80 (128 decimaO hut will be filled with all 
$1A. There are two tables of twelve sectors each in the 
formatts screen layout page. They should be considered 
sequential (there wasn't enough room to fit 24 sectors on one 
row!) The table below the sector tables contains the gap 
length byt a. 

Bceaiae a track is only so long only a limited number of bytes 
can be placed on a track. After the I is the current number 
of bytes the formatter has calculated your format will use on 
the trade This number must remain between $BCO and $CBO 
for yow format to b« rtlUble. 

All sditing changes in the formatter will remain intact until 
you reboot the ARCHIVER/EOrrOR diskette. No defaults are 
stored back in this table. Therefore, you can go back and 
forth between the edit page and the format page without loss 
of th« Mw format 



The commands used in the Formatter are: 



Move cursor left one sector (or gap size 
value). 



♦ : Move euraor right one sector (or gap size 
value). 

t I Move cursor up one parameter field (i.e. 
FL. - LM - SB - gap values - FL . . .). 

t Move cursor down one parameter field. 

I Delete sector eur»or Is on or If the cursor 
Is past the last sector, delete the last 
sector. 

I Insert a sector before the sector that the 
etirser is on. 

i Clear entire format (start from scratch). 

t Hex entry overwrites what Is currently 
dislayed. 

ESC t Exit] go back to the Edit screen. 

W I Format the range of tracks ( «sa,y ) using 
the format created. 



DKLSTB 

IMSBVr 
CLEAl 
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5.15 TRACK MAPPER 



The address at which the sector bor'n« may be chaneed hy 
pressing the L key. Answer the prompt hy entering the new 
address In hexadecimaL This nddrr<;>! is used only a.^ a 
reference tni does not physically relocate the buffer contents. 



S.13 INSBBTING CUSTOM FORMAT 



Pressing the I key allows the insortion of custom format.' 
from the Formatter page into a rsncp of tracks ( Rxx,jj ). 
The old tracks (if any) will be rcplncpfl. No sector data will 
transfer . To insert data in the new sectors, you must use the 
H and QOEXT keys. 



S.14 MOVING TSACKS 



TraekB can be moved (but not duplicated) by pressing the N 
key. The track currently displayed will be renumbered to a 
new track number that you enter. The track currently at the 
destination spot will be deleted and the track you are on will 
be deleted from its current place and be moved to the new 
locatioa 



1^ Pressing an M Is used for entering the Mapper pngo. This 
function will allow you to examine the format of indivirtiinl 
tracks. The moat significant function of this command is to 
p allow you to determine the gap size between successive 
sectors. 

The SE is the sector number that originates from the sector 
header. (Refer to figure 5-3.) The TR is the track number 
as found in the sector header, and the LH is the sector 
length byte. For more Information on these values, refer to 
section 6.3. The TI Is the amount of time between tlmt 
sector and the succeeding sector in units of 2048 (dcctmni) 
microseconds. There are about 100 (decimal) units of time on 
a track, so the sum of these numbers should be about 100. 





5 es 05 es 
e es ea ee 

6 as as ea 
a ea ae ee 





Figure 5-3. Track Map Layout 
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The ST is the status of tlir sci-Iit linider rend. Aiiytliiiig 
other than a zero meaas thnt the sector can not ever be 
accesse<l Also, any A4 reod format mode will not return 
the Tl and ST values. This is because the A4 mode 
goes for quantity as far as sectors po, while the A6 modes 
for quality of Information per sector. 

NOTE 

The last sector's Tl (time) value will only 
be correct on an A6> read format mode. 



5.16 ENTER THE ARCHIVER 



To enter the ARCHIVEU from the rniTO« you must type an 
A . CAUTION; all dnta eurrenllv in the data buffers will he 
lost as soon as the ARCIIIVFR command C is used. How- 
ever, the data will not be lost if you immediately return to the 
EDITOR. 



CHAPTERS 
OCR FORMATTING THEORT 



By far the most powerful feature of the CHIP over tlie Atnri 
C ROM is its ability to create custom formats and 
I successfully write (and read) sectors of these formats. Fly no 

means do we expect you to fully understand the pecullnritics 
I of disk formatting and general I/O with one reading. 
I Remember, It took a couple of years for software houses to 

devise even the simplist of protection schemes, so don't expect 

to learn it all in an hour. However, we feet that to use the 
I AHCIllVER/EDITOR to its fullest, at least some basics sliould 
' be understood. In this chapter, the very basics will be 

presented, and gradually the specifics of the track layout and 
I protection schemes will b« dealt with. 



R.l AN OVERVIEW 



The Atari 810 Disk Drive is an intelligent drive which means it 
I is just another computer, capable of reading and writing 
diskettes and relaying the Information to and from the main 
computer. The CHIP Is Just a program much like the Atari OS 
I that adds a wide variety of functions to the 810 Disk Drive. A 
description of the commands understood by the old ROM C 
and the operation of the SIO Is given In the Atari 06 manual so 
it will not be repeated here. For the remainder of this 
chapter, only the workings of the di.sk drive and the CHIP will 
be considered, so it Is assumed that you know the theory of 
communication between the computer and the disk drive. 
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6.2 DBK£TTESTRnCTDa£ 



6.3 THE BASICS OF A 3BCTOR 



A diskette is composed of a thin mnirnetie disk covered by an 
outer rigid black cover. The outer rover (or jnckct) has an 
oval open area on both sides exposing the disk surface to the 
drive read/write head. As the diskette spins about its central 
hub while Inside the drive, the read/write head hovers over the 
jacket oval opening and reads the disk surface much like a 
cassette recorder would. 

The diskette is electromagneticnlly divided into 40 tracks. A 
track Is a ring about the center of llic diskette. The di^k 
drive's head can be positioned prmsrlv over nny one of the 4(1 
tracks, thus data can be sequentiflUv rend in as the disk 
surf4e« spins underneath the head as in a cassette recorder. 

The track data magnetic fields nre converted into electric 
pulses which are fed to the FDC (floppy disk controller). The 
FDC is the interface between the rend/write head and the 
drive's microprocessor. The Fnr is responsible for 
interpretting and proces^inp commands from the 
microprocessor. The FDC performs nil sector searches nnd Is 
an intermediary on all sector data trnnsfers between the 
microprocessor and the physical disk surface. 

Because each track contains too much data that must be 
handled for each revolution of the diskette a- subdivision of the 
track is necessary. Thus, the trnek is normally divided into 18 
sequential sectors of $80 (125) bylrt of dnta each. Besides 
being easier to deal with, error ehoekin^ nnd rclinhility nrc not 
much of a problem. As you may be nwnrc, all the protection 
schemes deal with the sector in one form or another, so the 
rest of tills chapter will deal explicitly with the sector. 



A sector has two parts to Its the header and the data. Becaa^'c 
the track Is circuUr, there is no way to distinguish the 
I beginning of a track from the middle, thua, a sector needs to 
be able to Identify Itself to the controller. This Is the purpose 
of the sector header. These sector headers are written during 
formatting, so the sector can be identified upon subsequent 
reading and writing to and from the sector. 

Figure S-1 shows the typical 810 sector/track layout formit 
and the following paragraphs dcaerltx the various contents 
F that make up the sectors. 
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FIgur* 6-1. Sector/Track Format 
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6.4 TRACK LAYOOT/FORMAT 



I 6.S THE READ COMMAND 



Disk formatting is accomplished by the write track command. 
Each byte for the entire track must be provided for proper 
formatting Ineludinc the gaps as welL 

The FDC requests each byte in turn nnd places it directly onto 
the surface of the diskette. However, there are exceptions to 
the rule. If data bytes $FS through $FE are fed to the FDC, It 
reco^izes these as special control bytes and take appropriate 
action. The byte sequence is illustrated in figure 6-1. 

Gap size restrictions: 

GAP 1 I This is always 25.S (SFF) bytes and may be over- 
written by the last sector on the track. This is 
to ensure that no garbage remains between the 
Uat sector and the first. 

GAP 2 I (Poit Index AM gap) This gap should b« at least 
one (1) byte. 

GAPS t (Pre ID AM gap) This gap should be at least one 
byte. 

GAP 4 > (Post ID CRC gap) This gap must be $11 (IT) 
bytes in length. (See Read/Write sections.) 

GAP S I (Post DATA CRC gap) This gap should be at 
least one, however, in practice, it should be 
over 9 bytes long. 1liis is to protect the next 
sector header from being overwritten. 



When the processor issues the read command to the FDC. a 
search for the sector header begins. The FDC reads the 
headers of the sectors it finds and compares the sector number 
and the track number to those given by the processor. If the 
test fails, the search continues. Next, the CRC is checked for 
validity; if not correct, the search continues. If aU is correct, 
the FDC begins searching for the data AM. If found within 28 
bytes, the sector is read byte by byte and Is transferred to the 
processor. Finally, the CRC is checked for validity at the end. 
1 The CRC status error bit is set accordingly. Also, the type of 
data AM bvte will determine the status' of bits 5 and s of the 
status register. If the sector is never found ie. ID fields don't 
match, bit 4 of the status is set, and the processor (CHIP) will 
reposition the head In hope that somehow the head had gotten 
over the wrong track (grind!!), and try again. 



6.6 THE WRITE COMMAND 



This works identieallv to the read command except that once 
the sector has been located, a write occurs. NOTE: The write 
requires that $11 (17) gap bytes be between the sector header 
and the data. Also, the data AM byte's value depends upon the 
last two bits of the write command byte. On three of the four 
possibilities, the processor wiU Interpret the sector as 'bad' 
(see section 6.11). 



THE CHIP'S LOGIC SEEKING READ/WRITE COMMANLS 



These are the read and write commands that are used for 
double sectors. The CHIP wiU first compare the sector 
sequence it contains to what it finds on the diskette. When it 
syncronizes itself to the sequence, the write or read function 
described in section 6.5 and 6.6 will take place. The CHIP is 
able to get the sector headers through a read addre-^s 
command (of the FDC) which returns the six bytes contained 
in the sector header (track,..., CRC bytes). 



6.8 READ FORMAT COMMANU8 



Using ttl« method described Hbove, thr sector sequence can be 
fetched. On the A* modes, the hcnricrs are continuously 
read for slightly more than one revolution. After this, the 
sector numbers are compared on the next revolution nnd the 
first sequence is cropped to agree with what it finds the 
second time through. The A- modes read for about one 
revolution but no double check is made. 



In the above format, the sequential sectors are nine arnrt 
except for the end of track gap, in which ease they ire eielit 
apart. Here, that gap is large enough such that the eighth can 
just be read before the head passes It by (or rather It p«ssps 
the head by). This format is the fastest format possible on the 
810 disk. 



S.9 aiO SPEED RESTRICTIONS 



fi.lO DOOBLE SECTORS 



The disk drive's processor (and therefore the FDC) receives a 
full sector of data every 1/18 of a disk revolution. This is 
about .0115 second, however, the scrinl transfer between the 
computer and the disk drive is considcrnbly slower, (about .(19 
second). Now, since the diskette is turning at 288 RPM (or 4.8 
rpms), If you do a little math, you will find that only two 
sectors can be read in one disk revolution. This is the concept 
behind fast formats. 



SjttUieSiiBIBIIIllff 

Above is the standard format used in llie rillP ns well as the 
Atari ROM C. Notice thnt consr<iiietivc numbered sectors are 
nine apart within the sequence and ten opart when crossing the 
end of track gap (which is about holf a sector in length). If 
you are thinking ahead you may realize that even this format 
can be improved upon. 



Now suppose that two sectors had the same number. If you 
just randomly went and read that numbered sector, you could 
get two different sets of data. This process can be precisely 
controlled by first reading the sector nine (9) places before the 
one you really wish to read, and then read the one you want. 



000000000010000000 
54657(879829213243 



abcdefghi j kl mnopqr 



The above sector sequence contains 18 unique sectors but 8 
numbers are duplicated. (This is actually a formst used in the 
protection of one software house.) Now suppose you read 
sectors In the following order: 

12, 4, 9, 5, 3, 9. 
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6-7 



The actual physical sectors would be as follows: 

k, b, 1, d, o, L 

You will notice that the two rends of sector 9 did not yield the 
same result, thus this becomes a valid protection scheme. 
This is • rather new protection method (mid 1982), yet If is 
simple to understand and to duplicate (with the CHIP). This 
type of protection can ONLY be created with a drive 
modification (which is exactly how they are created in the 
first place). 

This idea can easily be expanded upon to include triple or 
quadrouple sectors. HOWEVER, the ability to consistently and 
reliably get the same results get.s harder with the more 
duplicate numbered sectors you have. Another application is 
to create more than 18 sectors and number two with the same 
number. Previously, this was difficult to grasp and realize the 
feasibility of such a scheme, however, now with the EDfrOR, 
you may create as many as 24 sectors on a traeic, but beeatse 
there is only so much room, many sectors must be cut short 
(and thus be bad sectors). A word of warning: the data in 
short sectors is not always reliable and timing between sectors 
is not the same. Timing becomes critical In importance and 
slight variations In speed may have adverse effects on 
protaetlona. 



6.11 BAD SECTORS 



The ability to write bad sectors has been around for quite a 
while now. It was the first type of true protection, but Is now 
becoming not so important It is possible to create two types 
of bad sectors with a standard 810 Disk Drive. The first is a 
CRC error and the second is a missing sector. The CRC error 
bad sectors were created by one of two methods; the first 
being slowing down the drive, and the second being the tape 
method. The missing sector was created by writing to the 
preceeding sector at a high RPM, thus causing the end of the 
first sector to overwrite the header of the next. 

Now, creating bad sectors is an easy and valuable function of 
the CHIP. To create a missing sector, simply format the trnck 
without that sector number. To create CRC bad sectors, 
special operations must be performed by the CHIP While 
writing the sector. These functions are all automatic and easy 
using the ARCHtVER/EDITOR, however, a brief description of 
each type will b« given below. 
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7.3 LOCKING POBMAT/WKITE/OPEN 



The CHIP contains a v/triable within il^ mpTiory which nllows 
the opening of the ClilP and of v/irious 'vrite type comnnrts. 
This feature will probahly Ni;vci( NF.I'.n TO HE USKD! 
However, Just In ease, location $ini) contniiu the needed 
Information that will TOTALLY lock the CHIP from outside 
mischief. The modifying of $19D would normally be done in 
the txjot sector, which you would need to write. 



7.4 MACHINE LANGOAGE INTKRPACE 



The CHIP can allow user prnirroms to be transferred to and 
executed within the data buffer inside of the 810 Disl< Drive. 
This allows for even more flexibility to denl with unforeseen 
situations, thus the CHIP truly is expandable. For more 
Information on the Inner workings of the CHIP, please contact 
Spartan Software of MN Inc. 



7.5 TRACING 



The CHIP also supports two types of tracing. One of which 
keeps track of how many times a particular track is accessed. 
The other type keeps a listing of the sector numbers read, 
given some starting sector. These features will be supported 
by an ARCHtVER 2.0 when released. 



CHAPTER 8 
DSEPUL HINTS 



This chapter will denl with tracks and useful thinps you mny do 
ii.'inj; your A RCIlIVKn/F.niTOR program. This cimptcr is 
specifically designed to help the user backup a program that 
wouldn't work when the defaults were used. 



8.1 CYCLIC FORMATS 



Consider the following formula: 



000000000000000000 
123456789123458789 



If you write out data using this format you may find that you 
get a verify error, why? The answer is really quite straieht 
forward. Since all the sectors are doubles, the logic seeking 
commands will be used, but now how does the logic seeking 
command locate the sector? It can't because it has no way of 
distinguishing the first half from the second. The solution to 
this problem is to turn the logic seeking commands OFF ( L- ) 
Hnd the compaction OFF ( C- ). Also, you should turn the 
■crify off ( V- ). This will cause each sector to be read in 
c>'rreetly because two sectors will be fetched per revolution 
an I the sectors will automatically be written correctly. 
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8.2 20 OB MOR£ SECTTORS 



8.4 GETTING BID OF LOOD SECTOBS 



The ARCHIVER can only hniidle rciidinc nnri writititr a 
maximum of 19 sectors, however, the EOfPOR can handle 24. 
If 1 diskette does contain more th.in 20 sectors, the custom 
formatter must be used and some sectors must be shortened. 
Notice that 20 full sectors can be written if you set all gaps 
(except the POST ID ORG) to one (I). However, if morp than 
20 sectors are being used, you m\ist do some intelligent 
guessing on which sectors are shortened and go from there. 
Once you made the format, writing the sectors is easy. The 
sector sequences must match and the formatting flag should 
be turned OFF. Also the bad sector flag matt be turned to a 
B- and CRC error bad sector symbols must be created under 
the sector number (the B command, in the EDITOR of 
course). Next the sector data must be modified so that the 
last byte in the bad sectors is the actual number of bytes to be 
written to the sector. Finally, you write the track and hope it 
works, otherwise try again. At the time of this writing. NO 
software company had ever used 20 or more sectors in a 
format (nor did they have the ability to). 



Many software companies Insist on checking missing sectors, 
thus the loud noises as the program boots. Because most 
software companies do not check the status after such a rend, 
you may replace their format with a new one that contains the 
required sectors and the ones that made the noise. When the 
new format has been created, you must Insert bad sectors. 
The easiest way to do this Is to position over the new sector 
and press the B (first you must get data Into that sector). 
When you have selected all sectors that need to be bad, then 
write the sectors out, and usually the program will work. 



8.3 GABSAGE TRACES 



Occasionally, you may run into tracks that return a read 
format error. (This has only happened once to my knowledge.) 
This is because the tracks' are badly gartiled and the second 
pass does not return the same results as the first pass. This 
will only happen on unformatted trucks, in which cnse random 
numbers appear as the sector numbers. To solve this problem, 
simply switch to a AS- read format mode. 
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APPENDIX E: ERROR MESSAGES 



APPENDIX E: ERROR MESSAGES (Continuedl 



FORMAT ERROR 



READ FORMAT ERROR 



After fornifltting n trnok. 
the verify foiinri the trnck 
to he bnd. Try a^nin, And 
if it persists, the diskette 
is likely bad. 

The CHIP wns iinsucco*j^fiiI 
at Kottinrr thr srctnr 
sequence from thp disk- 
ette. If you suspect more 
thfln 21 sectors, use a 
A4 mode, otherwise use 
a Ax- mode. 



READ/WRITE ERROR (STD) 



sector could not be read 
(or written). This is a 
standard read/write com- 
mand and should never 
happen, unless you have an 
unreliable drive. 



KEAO/WRJTE ERROR (P06) 



A logic seeking read/write 
command (sector) failed. 
Could be a format mis- 
match problem or an error 
as In above. 



rOO MANY SECTORS 



More than 25 sectors was 
encountered on the read 
format. Try piecing the 
track together by using 
A6- read mode repeat- 
edly. 
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U4PUT ERROR 



VERIFY ERROR 



OPENING ERROR 



MEMORY FULL 



Invalid enlrv, trv nrain. or 
consult npproprlnte spf 
tions rcgnrcliniT the pnrtic- 
ular function you tried. 

Tl>e verify pass failer' to 
yield ll\e same results as 
the dota written. Retry 
the write process. 

You entered thp wrontt 
code or drive of your ClUP 
when using the O com- 
mand. Retry the open. 

No more room to store the 
dnta on reads, inserts, etp. 
Write some of whnt you 
linve hHCk out to the disk 
and delete what is not 
needed. 
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